NAZWA¶

clearenv - czyszczenie środowiska

SKŁADNIA¶

#include <stdlib.h>

int clearenv(void);

OPIS¶

Funkcja clearenv() czyści środowisko z wszystkich par nazwa-wartość i nadaje zewnętrznej zmiennej environ wartość NULL.

WARTOŚĆ ZWRACANA¶

Funkcja clearenv() zwraca zero przy pomyślnym zakończeniu, a wartość niezerową w przypadku błędu.

DOSTĘPNOŚĆ¶

Brak w libc4, libc5. W glibc począwszy od glibc 2.0.

ZGODNE Z¶

Różne warianty Uniksa (DGUX, HPUX, QNX, ...). POSIX.9 (bindings for FORTRAN77). POSIX.1-1996 nie akceptował clearenv() ani putenv(), ale zmienił zdanie i ujął te funkcje w wykazie w jednym z późniejszychwydań standardu (por. B.4.6.1). Jednakże, SUSv3 dodaje jedynie putenv() a odrzuca clearenv().

UWAGI¶

Używana w aplikacjach, które są świadome zagrożeń. Jeśli jest niedostępna, to przypisanie

	environ = NULL;

Na stronach podręcznika dla DGUX i Tru64 jest napisane: Jeśli environ zostało zmodyfikowane przez cokolwiek innego niż funkcje putenv(), getenv() lub clearenv(), to clearenv() zwróci błąd, pozostawiając niezmienione środowisko procesu.

ZOBACZ TAKŻE¶

getenv(3), putenv(3), setenv(3), unsetenv(3), environ(5)